home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / tex / digex104.zip / DIGEXT.DOC < prev    next >
Text File  |  1991-08-15  |  5KB  |  157 lines
  1. DIGEXT - The Digest Extractor
  2.  
  3.  
  4. This README documents digext v1.04a
  5.  
  6.  
  7. COPYRIGHT
  8.  
  9.     Copyright (C) 1991, Alvin Koh.  All Rights Reserved.
  10.     Permission is granted to any individual or institution to use, copy, or
  11.     redistribute this software so long as it is not sold for profit,
  12.     provided this copyright notice is retained.
  13.  
  14.     Feel free to enhance the program, but do send me a copy of
  15.     your modifications.
  16.  
  17.     Send bug reports, bug fixes and modifications to:
  18.         ...!att!zpcp53!isakoh (UUCP) or
  19.         isakoh@zpcp53.att.com
  20.  
  21.  
  22. DESCRIPTION
  23.  
  24.     digext is for those who want to keep each digest issue in a
  25.     separate file without all those messy mail headers. This program
  26.     was inspired by Douglas Stumberger's and David Brown's undigest.
  27.  
  28.     digext extracts digest issues from files (which may contain more
  29.     than one digest issue) and stores them in separate files.
  30.  
  31.     Version 1.04a of digext recognizes the following digest formats:
  32.  
  33.         Digest           Stored as
  34.         ------           ---------
  35.         INFO-ZIP         IZIPvol.iss
  36.         INFO-C           ICvol.iss
  37.         Info-IBMPC       IIBMvol.iss
  38.         Info-Kermit      IKERvol.iss
  39.         INFO-WIZARD      IWIZvol.iss
  40.         UNIX-WIZARDS     UWIZvol.iss
  41.         VIRUS-L          VLvol.iss
  42.  
  43.         where vol is the digest volume number (3-digit with leading 0)
  44.           and iss is the digest issue number (3-digit with leading 0)
  45.  
  46.     If you do not like the naming convention used by digext, you can always
  47.     change it. You don't have to rename all your existing files too. Just
  48.     run them through digext to 're-extract' them. Don't send me the mods
  49.     if you do this.
  50.  
  51.     Some things to note. If a digest issue already exists, it is not
  52.     overwritten. Carriage Returns in the digest files are not removed.
  53.     Non-MSDOS users who wish to do this can use programs like Rahul
  54.     Dhesi's flip.
  55.  
  56.  
  57. USAGE
  58.  
  59.     digext file [ file ... ]
  60.  
  61.     e.g., digext infozip.digest infoc.digest infokermit.digest
  62.  
  63.         This will extract digests from the files infozip.digest,
  64.         infoc.digest and infokermit.digest.
  65.  
  66.     e.g., digext iz*.* ic*.*
  67.  
  68.         This will extract digests from all files matching the
  69.         filespecs iz*.* and ic*.*.
  70.  
  71.         Note: for some PC compilers, you will need to link to to
  72.         a wildcard expansion function for this to work. (See
  73.         COMPILING below).
  74.  
  75.  
  76. COMPILING
  77.  
  78.     UNIX System V or BSD:
  79.         cc -O -o digext digext.c -s
  80.  
  81.         (The -s ld option cuts the executable size by close to a factor
  82.         of two on some systems.  Seems to exist universally.)
  83.  
  84.  
  85.     Microsoft C 6.0:
  86.         cl digext.c setargv.obj /link /NOE
  87.  
  88.         Linking with setargv.obj will allow command line wildcard expansion.
  89.         Add the path prefix to setargv.obj accordingly. /NOE is required to
  90.         prevent multiple definition errors when linking. setargv.obj is
  91.         distributed with MSC 6.0 in the lib directory.  __STDC__ is
  92.         defined by default.
  93.  
  94.  
  95.     Turbo C 2.0:
  96.         tcc -A digext.c wildargs.obj
  97.  
  98.         wildargs is functionally similar to MSC 6.0's setargv (see MSC 6.0
  99.         above). Also add the path prefix accordingly. wildargs.obj is
  100.         distributed with TC 2.0 in startup.arc.
  101.  
  102.         If you are using the integrated development environment to compile
  103.         digext.c, be sure to set 'Options/Compiler/Source/ANSI keywords only'
  104.         to ON. This is to define the __STDC__ macro.
  105.  
  106.  
  107.     Borland C++ 2.0:
  108.         bcc digext.c wildargs.obj
  109.  
  110.         See Turbo C 2.0 above. wildargs is distributed with BC++ 2.0 in the
  111.         lib directory.  __STDC__ is defined by default.
  112.  
  113.  
  114.     VMS (tested under v5.2 with VAX C v3.0):
  115.         @make_digext
  116.  
  117.  
  118. HISTORY
  119.  
  120.     1.01   27 June 1991  Alvin Koh (isakoh@zpcp53.att.com)
  121.         Creation...
  122.  
  123.     1.02   28 June 1991   David Kirschbaum (kirsch@usasoc.soc.mil)
  124.         Added include files for compilation under Turbo C.
  125.  
  126.     1.03   6 July 1991   Alvin Koh (isakoh@zpcp53.att.com)
  127.         Added lookup table to support various digest types/formats.
  128.         I have only tested digext with INFO-ZIP and UNIX-WIZARDS digests
  129.         so far, as these are the 2 digests I subscribe to currently.
  130.         Please send me you bug reports, enhancements and new formats.
  131.  
  132.     1.04   10 July 1991   Alvin Koh (isakoh@zpcp53.att.com)
  133.         Changed the various *unwieldy* sscanf formats to short and
  134.         more manageable ones. Volume and Issue variable changed from
  135.         char[80] to int.
  136.  
  137.     1.04a  13 August 1991   Cave Newt (roelofs@amelia.nas.nasa.gov)
  138.         Tweaks for VMS/VAXC compilation (didn't like void main; return 
  139.         status must be zero or else interpreted strangely; added wildcard
  140.         code).  Tested a little bit on INFO-ZIP digests.
  141.  
  142.  
  143. CREDITS
  144.  
  145.     David Kirschbaum for testing, enhancing, and distributing digext
  146.     for me.
  147.  
  148.     Greg Roelofs for the VMS/VAXC stuff.
  149.  
  150.  
  151. ------------------------------------------------------------------------------
  152. Alvin Koh    E-MAIL:    ...!att!zpcp53!isakoh
  153.             isakoh@zpcp53.att.com
  154.         Phone:    (065) 740-3413 (Timezone: GMT-8)
  155.         FAX:    (065) 744-9577
  156. ------------------------------------------------------------------------------
  157.